home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat2 / utimes.0 < prev    next >
Text File  |  1996-09-02  |  3KB  |  71 lines
  1.  
  2. UTIMES(2)                  UNIX Programmer's Manual                  UTIMES(2)
  3.  
  4. NNAAMMEE
  5.      uuttiimmeess - set file access and modification times
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//ttiimmee..hh>>
  9.  
  10.      _i_n_t
  11.      uuttiimmeess(_c_o_n_s_t _c_h_a_r _*_f_i_l_e, _c_o_n_s_t _s_t_r_u_c_t _t_i_m_e_v_a_l _*_t_i_m_e_s)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The uuttiimmeess() function sets the access and modification times of the named
  15.      file.
  16.  
  17.      If _t_i_m_e_s is NULL, the access and modification times are set to the cur-
  18.      rent time.  The caller must be the owner of the file, have permission to
  19.      write the file, or be the super-user.
  20.  
  21.      If _t_i_m_e_s is non-NULL, it is assumed to point to an array of two timeval
  22.      structures.  The access time is set to the value of the first element,
  23.      and the modification time is set to the value of the second element.  The
  24.      caller must be the owner of the file or be the super-user.
  25.  
  26.      In either case, the inode-change-time of the file is set to the current
  27.      time.
  28.  
  29. RREETTUURRNN VVAALLUUEESS
  30.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  31.      of -1 is returned and _e_r_r_n_o is set to indicate the error.
  32.  
  33. EERRRROORRSS
  34.      UUttiimmeess() will fail if:
  35.  
  36.      [EACCES]      Search permission is denied for a component of the path
  37.                    prefix; or the _t_i_m_e_s argument is NULL and the effective us-
  38.                    er ID of the process does not match the owner of the file,
  39.                    and is not the super-user, and write access is denied.
  40.  
  41.      [EFAULT]      File or _t_i_m_e_s points outside the process's allocated ad-
  42.                    dress space.
  43.  
  44.      [EIO]         An I/O error occurred while reading or writing the affected
  45.                    inode.
  46.  
  47.      [ELOOP]       Too many symbolic links were encountered in translating the
  48.                    pathname.
  49.  
  50.      [ENAMETOOLONG]
  51.                    A component of a pathname exceeded {NAME_MAX} characters,
  52.                    or an entire path name exceeded {PATH_MAX} characters.
  53.  
  54.      [ENOENT]      The named file does not exist.
  55.  
  56.      [ENOTDIR]     A component of the path prefix is not a directory.
  57.  
  58.      [EPERM]       The _t_i_m_e_s argument is not NULL and the calling process's
  59.                    effective user ID does not match the owner of the file and
  60.                    is not the super-user.
  61.  
  62.      [EROFS]       The file system containing the file is mounted read-only.
  63.  
  64. SSEEEE AALLSSOO
  65.      stat(2),  utime(3)
  66.  
  67. HHIISSTTOORRYY
  68.      The uuttiimmeess() function call appeared in 4.2BSD.
  69.  
  70. 4th Berkeley Distribution        June 4, 1993                                2
  71.